home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / grafix / 3d / off2real.lha / OFF2Real.doc next >
Encoding:
Text File  |  1994-12-12  |  6.3 KB  |  120 lines
  1. OFF2Real v0.1 (alpha) -- Documentation
  2.  
  3. ABSTRACT:
  4.      OFF2Real converts 3d-object files from OFF format to Real3D v2.47 format. The
  5.      coordinates of the converted object can be scaled to values between 0 and 1 in
  6.      order to achieve optimal precision and ease of use in Real3D.
  7.      The OFF file should be generated by `tddd2off`, a program from the TDDD-Lib
  8.      package by Glenn Lewis which allows various conversions from Imagine´s TDDD
  9.      format. TDDD-Lib is available on Aminet in gfx/3d/.
  10.  
  11. LEGAL:
  12.      OFF2Real is FREEWARE, you can use and distribute it at no cost but not for profit.
  13.      Please leave this documentation with the program.
  14.      One appeal though:
  15.      If you are a talented 3d-designer and created some interesting objects or if you
  16.      are a programmer and developed an interesting program, which didn´t cost you too
  17.      much effort, consider to distribute your work as freeware for the benefit of all.
  18.      I think the idea of freeware is a wonderful unselfish concept which should be
  19.      supported (You know, the best things in life are for free...)
  20.  
  21. WARNING:
  22.      This program is in a very early developement stage, so be sure not to work on
  23.      anything important while you try it out and better use RAM:, SD0: or a similar
  24.      volatile data carrier for storage of intermediate files generated during the
  25.      conversion process. You have been warned...
  26.      (It never crashed on my computer, though.)
  27.  
  28. REQUIREMENTS:
  29.      The program is written in ANSI-C and compiled with gcc v2.6.1 using the `-m68000`
  30.      switch, so in theory all you need is the ixemul library (version 40.4 or higher)
  31.      in your LIBS: directory. However, I was not able to test the program on any
  32.      computer other than my A4000, so if you run into problems send me an E-mail and
  33.      I will try to fix it.
  34.  
  35. USAGE:
  36.      The program should be started from CLI with
  37.  
  38.          `OFF2Real <-scale | -noscale> <OFF-File> <Real3d-File>`
  39.  
  40.      (substitute suiting filenames for <...>). First of all, however, you would want
  41.      to convert a 3d-object from TDDD format to OFF format by
  42.  
  43.          `tddd2off -geom <TDDD-File> <OFF-File>`.
  44.  
  45.      For example, let´s say you have a stunning masterpiece called `my_object.iob`
  46.      in your current directory together with `tddd2off` and `OFF2Real`.
  47.      `tddd2off -geom my_object.iob RAM:test_object` will create a file named `test_object.geom`
  48.      located in RAM: (remember my warning ?).
  49.      Now typing `OFF2Real -scale RAM:test_object.geom RAM:test_object.r3d` will generate an
  50.      object file in Real3D v2.47 format called `test_object.r3d` in RAM:. This object can
  51.      be loaded directly into Real3D by the menu entry `Project/Objects/Insert` and will
  52.      show up as `RAM:test_obje` (simply the OFF-filename trimmed to 15 characters) in the
  53.      Select Window.
  54.      It should be no problem to integrate the two conversion steps into a shell script
  55.      which will offer you a direct "TDDD2Real" functionality (just take a look at the
  56.      supplied `T3D2Real` script and you will get the idea).
  57.  
  58. PROS:
  59.      The converted object is a so called TRISET Real3D primitive, which keeps file size,
  60.      memory usage and rendering speed down in comparison to numerous triangle primitives.
  61.      Furthermore you can ask Real3D to do a Phong shading with the object (by choosing
  62.      the menu `Modify/Freeform/Type`) which will produce a smoother look in rendering.
  63.  
  64. CONS:
  65.      The converted object is a so called TRISET Real3D primitive, which means that only
  66.      triangular modelled objects can be converted (no splines, spheres etc.). Additionally
  67.      it can only have a uniform color due to a limitation of Real3D. This fact gets even
  68.      worse because OFF2Real at this moment is unable to convert the original hierarchy of
  69.      the Imagine object (in fact there is no hierarchy information in an OFF file).
  70.      Fortunately there are ways to overcome these problems:
  71.  
  72.      1. If you own Imagine (I don´t) there should be a possibility to save each subobject
  73.         and convert them individually (this might be tedious, I know)
  74.         Note: I just discovered that tddd2off supports a `-split` switch which will split
  75.         an object into its subobjects (thus generating several ".geom" files)
  76.  
  77.      2. Use single-colored brushmaps to recolor the object in Real3D
  78.  
  79.      3. Wait for the next version of the program, which will hopefully be able to convert
  80.         the original hierarchy (this is high on my priority list)
  81.  
  82. PROBLEMS:
  83.      I was able to test the program with a few objects from Aminet in gfx/3dobj/ and so far
  84.      only had problems with a huge object file of a `57 chevy (Real3D loads it ok, but is
  85.      not able to do anything with it), but since `showobj`, a TDDD-object viewer, couldn´t
  86.      display it properly I don´t know if OFF2Real is to blame for it (By using the `-split`
  87.      switch of `tddd2off` I was able to convert it, though).
  88.      Apart from this there are probably still a lot of bugs in this program and if you find
  89.      some please tell me about it by E-mail.
  90.      A potential source of trouble is the OFF-file which has to follow EXACTLY the syntax
  91.      generated by `tddd2off` i.e.:
  92.  
  93.      Line 1:                 <# of points> <# of faces> <# of edges>
  94.      Line 2:                 <x coord>     <y coord>    <z coord>
  95.      ...
  96.      Line <# of points> + 1: <x coord>     <y coord>    <z coord>
  97.      Line <# of points> + 2: `3`  <index 1>  <index 2>  <index 3>
  98.      ...
  99.      Line <# of points> +
  100.           <# of faces>  + 1: `3`  <index 1>  <index 2>  <index 3>
  101.  
  102.      This means that OFF2Real3d cannot be used as a general OFF format converter at this
  103.      moment. Due to the rather simple structure of this format it shouldn´t be hard to
  104.      add this functionality if there is need for it (i.e. lots of interesting objects in
  105.      OFF format).
  106.  
  107. HINTS:
  108.      You can use `tddd2dxf` from TDDD-Lib and Realsoft´s DxfToRPL to convert your objects
  109.      to separate triangles. As said before this type of conversion has its drawbacks, but
  110.      it allows you to unleash Real3D´s particle system on your object (Explode it, blow it
  111.      away, etc.). Hey, one could even use both types of objects in a single animation, I
  112.      have to try this out...
  113.  
  114. CREDITS:
  115.      Glenn "T3D" Lewis for his excellent TDDD-Lib
  116.  
  117. AUTHOR:
  118.      Alexander Vilbig, microbiologist and computer scientist in spe
  119.      Send bug-reports, suggestions, etc. to vilbig@informatik.tu-muenchen.de
  120.